home *** CD-ROM | disk | FTP | other *** search
/ Aminet 48 / Aminet 48 (2002)(GTI - Schatztruhe)[!][Apr 2002].iso / Aminet / text / misc / OneLine.lha / OneLine.readme < prev    next >
Encoding:
Text File  |  2002-01-20  |  4.9 KB  |  185 lines
  1. Short:     Convert CR-LF-TAB & spaces in a text file
  2. Uploader:  Vincenzo Barbarulo (barbarulo.vince@infinito.it)
  3. Author:    Vincenzo Barbarulo (barbarulo.vince@infinito.it)
  4. Type:      text/misc
  5. Date:      20-Jan-2002
  6. Version:   1.1
  7. Replaces:  text/misc/OneLine.lha
  8.  
  9.  
  10.  
  11. Introduction
  12. ------------
  13. I've written this program because no freeware program on Aminet converts a
  14. text file in "One Line" only!.
  15.  
  16. WHY DO THIS??
  17.  
  18. So, this program is useful when you want to import a text in a DTP or WP program
  19. and you want to put the text in a number of columns greater or different from
  20. the original text.
  21.  
  22. In that case you have to go at the end-line, "DEL" last character and
  23. (not always) press "SPACE", for all the "end-line" of the text.
  24. OneLine do that for you and converts at one time CR,LF,TAB & dblSPACES!!
  25.  
  26.  
  27.  
  28. Requirements
  29. ------------
  30. Any Amiga with at least OS 2.04 and some Mb of RAM (!) if you want
  31. to convert/save big files into RAM. (see History)
  32.  
  33.  
  34.  
  35. Features
  36. --------
  37.  - FREEWARE. No requesters and no expiry date.
  38.  - Detect CR, LF, TAB
  39.  - Detect multiples spaces
  40.  - Detect the spaces before comma
  41.  
  42.    ...in a text file of any length.
  43.  
  44.  
  45. I've tested this program on my:
  46.  
  47. A4000, CyberStormMKIII 060/50, 128Mb RAM, CVisionPPC, OS 3.5,
  48. HD9.1Gb ATLAS SCSI-UW, HD10.5Gb Samsung IDE, CanonBJC-4400,
  49. MustekParagon-1200SP, CDROM 48x
  50.  
  51. Speed NOTE:
  52. On my A4000 OneLine converts and saves a file of ~600Kb of text in ~2 - ~2.5 secs
  53. and another of ~3500Kb in ~13 secs, but the speed depends by the file
  54. (number of the spaces and/or TAB).
  55.  
  56.  
  57.  
  58. Usage
  59. -----
  60. From shell only:
  61.  
  62.                               |^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^|-> (any order)
  63. Type:  Oneline <in_file_path>  <out_file_path> -t -d -c . . . STDOUT
  64.  
  65.        <in_file_path>   Name and path of the file to convert
  66.  
  67.        <out_file_path>  Name and path of the destination file
  68.  
  69.        -t               TAB option: if it's present, the program erases the TAB 
  70.                         characters too
  71.  
  72.        -d               Multiples Spaces Option: if it's present, the program
  73.                         erases the multiples spaces adjacents
  74.  
  75.        -c               Comma OPTIMIZE: if it's ON, OneLine erases the spaces
  76.                         before the ',' chr. and add a space after ',' if isn't present.
  77.  
  78.        STDOUT           is the file "RAM:STDFile_OneLine.txt" that is used if
  79.                         isn't destination file specified
  80.  
  81.  
  82.  
  83.  
  84. To do
  85. -----
  86. Add   "Directory scan" option; (to convert a whole directory of text files);
  87.  
  88. Add   "Asl requester";  *
  89.  
  90. Add   a GUI & an icon for WB usage; *
  91.  
  92. Some speed improvements
  93.  
  94. *(Perhaps!: I don't know if could be very useful.)
  95.  
  96.  
  97.  
  98.  
  99. Legal stuff
  100. -----------
  101. OneLine is freeware. It may be distributed freely as long as
  102. no modifications are made to the executable and to this document.
  103.  
  104. ...but if you send me an EMail also empty(!) with the subject
  105. "OneLine user!" you make me greater!!!:
  106. only would i know how many peoples use this program!
  107.  
  108. Compiled with VBCC.
  109.  V0.8 (c) in 1995-2001 by Volker Barthelmann
  110.  
  111.  http://it.aminet.net/pub/aminet/dev/c/vbcc.lha
  112.  
  113.  
  114.  
  115. BUGS
  116. ---
  117. -B1 ?OneLine don't "seems" to convert, but only in some files, a CR
  118.      characters. Some programs, like EditPad and Pagestream©, shows this CRs.
  119.      Other programs like CED4, Type (AmigaDOS), DOpus viewer and OneLine too,
  120.      (by running again on the dest_file), don't detects and shows them.
  121.      I think that they're Unicode CHRS.
  122.      See History.
  123.  
  124.  
  125. I have tested many times OneLine and it hasn't crashed my system.
  126.  
  127. But if you find a bug please send me an Email with the subject
  128. "OneLine bug" and tell me your configuration.
  129. (the file with the 'text frame' that generate the bug.
  130.  
  131.  
  132.  
  133.  
  134. History
  135. -------
  136. 0.4   -(internal) Detect and remove only CR & LF chrs  (23-Dec-2001)
  137.  
  138. 0.6   -(internal) Detect and remove TAB chrs
  139.  
  140. 0.9   -(internal) Detect end remove doubles (or > 2) spaces
  141.        (convert n spaces in 1 space chrs)
  142.  
  143.       -Added "Show converted text" option
  144.  
  145.       -Added "? number of columns" label
  146.  
  147.  
  148. 1.0   First public release. (04-Jan-2002)
  149.  
  150.       -Added  "number of CR, LF, TAB and Spaces removed" info
  151.  
  152.       -I have checked the files that generate the bug "B1" with DPU and other
  153.       Hex-Dump Tools too and i don't find any CR chrs after OneLine usage...
  154.  
  155.       -Speed improvement (compiled with VBCC 0.8 ---faaaster!!---)
  156.  
  157.  
  158. 1.1   -Added Overwrite request
  159.  
  160.       -OneLine now allocate the needed memory before starting conversion
  161.  
  162.       -Added 'File length' infos
  163.  
  164.       -Added '-d' option to switch on/off the "Erase multiples spaces" feature
  165.  
  166.       -Added 'Comma Optimize' option: erases the spaces before commas and add
  167.        one space after (comma) if isn't;
  168.  
  169.        i.e. "number of CR , LF ,TAB and Spaces removed"
  170.                              ||
  171.                              \/
  172.             "number of CR, LF, TAB and Spaces removed"
  173.  
  174.       -Some speed emprovements (if it's used without the options)
  175.  
  176. ME!
  177. ---
  178. Vincenzo Barbarulo
  179. C.so Mazzini
  180. Cava de' Tirreni (SA)  84013
  181. ITALY
  182.  
  183. barbarulo.vince@infinito.it
  184.  
  185. P.S.:sorry if my english isn't good!!!!